A Software-Defined Radio 
for the Masses, Part 2 


Come learn how to use a PC sound card to enter 


the wonderful world of digital signal processing. 


art 1 gave a general description 

of digital signal processing 

(DSP) in software-defined ra- 
dios (SDRs).! It also provided an over- 
view of a full-featured radio that uses 
a personal computer to perform all 
DSP functions. This article begins de- 
sign implementation with a complete 
description of software that provides 
a full-duplex interface to a standard 
PC sound card. 

To perform the magic of digital sig- 
nal processing, we must be able to con- 
vert a signal from analog to digital and 
back to analog again. Most amateur 
experimenters already have this ca- 


1Notes appear on page 18. 
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pability in their shacks and many 
have used it for slow-scan television 
or the new digital modes like PSK31. 

Part 1 discussed the power of 
quadrature signal processing using in- 
phase (I) and quadrature (Q) signals 
to receive or transmit using virtually 
any modulation method. Fortunately, 
all modern PC sound cards offer the 
perfect method for digitizing the J and 
Q signals. Since virtually all cards to- 
day provide 16-bit stereo at 44-kHz 
sampling rates, we have exactly what 
we need capture and process the sig- 
nals in software. Fig 1 illustrates a 
direct quadrature-conversion mixer 
connection to a PC sound card. 

This article discusses complete 
source code for a DirectX sound-card 
interface in Microsoft Visual Basic. 
Consequently, the discussion assumes 
that the reader has some fundamen- 


tal knowledge of high-level language 
programming. 


Sound Card and PC Capabilities 


Very early PC sound cards were low- 
performance, 8-bit mono versions. To- 
day, virtually all PCs come with 
16-bit stereo cards of sufficient quality 
to be used in a software-defined radio. 
Such a card will allow us to demodu- 
late, filter and display up to approxi- 
mately a 44-kHz bandwidth, assuming 
a 44-kHz sampling rate. (The band- 
width is 44 kHz, rather than 22 kHz, 
because the use of two channels effec- 
tively doubles the sampling rate—Ed. ) 
For high-performance applications, it is 
important to select a card that offers a 
high dynamic range—on the order of 
90 dB. If you are just getting started, 
most PC sound cards will allow you to 
begin experimentation, although they 


may offer lower performance. 

The best 16-bit price-to-perfor- 
mance ratio I have found at the time 
of this article is the Santa Cruz 6- 
channel DSP Audio Accelerator from 
Turtle Beach Inc (www.tbeach.com). 
It offers four 18-bit internal analog- 
to-digital (A/D) input channels and six 
20-bit digital-to-analog (D/A) output 
channels with sampling rates up to 
48 kHz. The manufacturer specifies a 
96-dB signal-to-noise ratio (SNR) and 
better than —91 dB total harmonic dis- 
tortion plus noise (THD+N). Crosstalk 
is stated to be -105 dB at 100 Hz. The 
Santa Cruz card can be purchased 
from online retailers for under $70. 

Each bit on an A/D or D/A converter 
represents 6 dB of dynamic range, so 
a 16-bit converter has a theoretical 
limit of 96 dB. A very good converter 
with low-noise design is required to 
achieve this level of performance. 
Many 16-bit sound cards provide no 
more than 12-14 effective bits of dy- 
namic range. To help achieve higher 
performance, the Santa Cruz card uses 
an 18-bit A/D converter to deliver 
the 96 dB dynamic range (16-bit) 
specification. 

A SoundBlaster 64 also provides 
reasonable performance on the order 
of 76 dB SNR according to PC AV Tech 
at www.pcavtech.com. I have used 
this card with good results, but I much 
prefer the Santa Cruz card. 

The processing power needed from 
the PC depends greatly on the signal 
processing required by the application. 
Since I am using very-high-perfor- 
mance filters and large fast-Fourier 
transforms (FFTs), my applications 
require at least a 400-MHz Pentium 
II processor with a minimum of 
128 MB of RAM. If you require less 
performance from the software, you 
can get by with a much slower ma- 
chine. Since the entry level for new 
PCs is now 1 GHz, many amateurs 
have ample processing power avail- 
able. 


Microsoft DirectX versus 
Windows Multimedia 

Digital signal processing using a PC 
sound card requires that we be able to 
capture blocks of digitized Z and Q data 
through the stereo inputs, process those 
signals and return them to the sound- 
card outputs in pseudo real time. This 
is called full duplex. Unfortunately, 
there is no high-level software interface 
that offers the capabilities we need for 
the SDR application. 

Microsoft now provides two appli- 
cation programming interfaces? (APIs) 
that allow direct access to the sound 
card under C++ and Visual Basic. The 
original interface is the Windows Mul- 


timedia system using the Waveform 

Audio API. While my early work was 

done with the Waveform Audio API, I 
later abandoned it for the higher per- 
formance and simpler interface 

DirectX offers. The only limitation I 

have found with DirectX is that it does 
not currently support sound cards 

with more than 16-bits of resolution. 

For 24-bit cards, Windows Multimedia 
is required. While the Santa Cruz card 
supports 18-bits internally, it presents 
only 16-bits to the interface. For in- 
formation on where to download the 

DirectX software development kit 

(SDK) see Note 2. 


Circular Buffer Concepts 
A typical full-duplex PC sound card 
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allows the simultaneous capture and 
playback of two or more audio chan- 
nels (stereo). Unfortunately, there is 
no high-level code in Visual Basic or 
C++ to directly support full duplex as 
required in an SDR. We will therefore 
have to write code to directly control 
the card through the DirectX API. 
DirectX internally manages all low- 
level buffers and their respective 
interfaces to the sound-card hard- 
ware. Our code will have to manage 
the high-level DirectX buffers 
(called DirectSoundBuffer and 
DirectSoundCaptureBuffer) to pro- 
vide uninterrupted operation in 
a multitasking system. The Direct- 
SoundCaptureBuffer stores the digi- 
tized signals from the stereo 
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Fig 1—Direct quadrature conversion mixer to sound-card interface used in the author’s 


prototype. 
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Fig 2—DirectSoundCaptureBuffer and DirectSoundBuffer circular buffer layout. 
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A/D converter in a circular buffer and 
notifies the application upon the 
occurrence of predefined events. Once 
captured in the buffer, we can read 
the data, perform the necessary modu- 
lation or demodulation functions us- 
ing DSP and send the data to the 
DirectSoundBuffer for D/A conversion 
and output to the speakers or trans- 
mitter. 

To provide smooth operation in a 
multitracking system without audio 
popping or interruption, it will be nec- 
essary to provide a multilevel buffer for 
both capture and playback. You may 
have heard the term double buffering. 
We will use double buffering in the 
DirectSoundCaptureBuffer 
and quadruple buffering in the 
DirectSoundBuffer. I found that the 
quad buffer with overwrite detection 
was required on the output to prevent 
overwriting problems when the system 
is heavily loaded with other applica- 
tions. Figs 2A and 2B illustrate the 
concept of a circular double buffer, 
which is used for the Direct- 
SoundCaptureBuffer. Although the 
buffer is really a linear array in 
memory, as shown in Fig 2B, we can 
visualize it as circular, as illustrated in 
Fig 2A. This is so because DirectX man- 
ages the buffer so that as soon as each 
cursor reaches the end of the array, the 
driver resets the cursor to the begin- 
ning of the buffer. 

The DirectSoundCaptureBuffer is 
broken into two blocks, each equal in 
size to the amount of data to be cap- 
tured and processed between each 
event. Note that an event is much like 
an interrupt. In our case, we will use 
a block size of 2048 samples. Since we 
are using a stereo (two-channel) board 
with 16 bits per channel, we will be 
capturing 8192 bytes per block (2048 
samples x 2 channels x 2 bytes). There- 
fore, the DirectSoundCaptureBuffer 
will be twice as large (16,384 bytes). 

Since the DirectSoundCapture 
Buffer is divided into two data blocks, 
we will need to send an event notifica- 
tion to the application after each block 
has been captured. The DirectX driver 
maintains cursors that track the posi- 
tion of the capture operation at all 
times. The driver provides the means 
of setting specific locations within the 
buffer that cause an event to trigger, 
thereby telling the application to re- 
trieve the data. We may then read the 
correct block directly from the 
DirectSoundCaptureBuffer segment 
that has been completed. 

Referring again to Fig 2A, the two 
cursors resemble the hands on a clock 
face rotating in a clockwise direction. 
The capture cursor, lPlay, represents 
the point at which data are currently 
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being captured. (I know that sounds 

backward, but that is how Microsoft 

defined it.) The read cursor, lWrite, 

trails the capture cursor and indicates 
the point up to which data can safely 
be read. The data after |Write and up 
to and including 1Play are not neces- 
sarily good data because of hardware 
buffering. We can use the lWrite cur- 
sor to trigger an event that tells the 

software to read each respective block 
of data, as will be discussed later in 

the article. We will therefore receive 

two events per revolution of the circu- 
lar buffer. Data can be captured into 

one half of the buffer while data are 

being read from the other half. 

Fig 2C illustrates the Direct- 
SoundBuffer, which is used to output 
data to the D/A converters. In this case, 
we will use a quadruple buffer to allow 
plenty of room between the currently 
playing segment and the segment be- 
ing written. The play cursor, lPlay, al- 
ways points to the next byte of data to 
be played. The write cursor, |Write, is 
the point after which it is safe to write 
data into the buffer. The cursors may 
be thought of as rotating in a clockwise 
motion just as the capture cursors do. 
We must monitor the location of the 
cursors before writing to buffer loca- 
tions between the cursors to prevent 
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overwriting data that have already 
been committed to the hardware for 
playback. 

Now let’s consider how the data 
maps from the DirectSoundCapture- 
Buffer to the DirectSoundBuffer. To 
prevent gaps or pops in the sound due 
to processor loading, we will want to 
fill the entire quadruple buffer before 
starting the playback looping. DirectX 
allows the application to set the start- 
ing point for the 1Play cursor and to 
start the playback at any time. 
Fig 3 shows how the data blocks map 
sequentially from the Direct- 
SoundCaptureBuffer to the Direct- 
SoundBuffer. Block 0 from the 
DirectSoundCaptureBuffer is trans- 
ferred to Block 0 of the Direct- 
SoundBuffer. Block 1 of the 
DirectSoundCaptureBuffer is next 
transferred to Block 1 of the 
DirectSoundBuffer and so forth. The 
subsequent source-code examples show 
how control of the buffers is accom- 
plished. 


Full Duplex, Step-by-Step 


The following sections provide a 
detailed discussion of full-duplex 
DirectX implementation. The example 
code captures and plays back a stereo 
audio signal that is delayed by four 


Fig 3—Method for mapping the 
DirectSoundCaptureBuffer to 
the DirectSoundBuffer. 
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Fig 4—Registration of the DirectX8 for Visual Basic Type Library in the Visual 


Basic IDE. 


capture periods through buffering. You 
should refer to the “DirectX Audio” 

section of the DirectX 8.0 Program- 
mers Reference that is installed with 

the DirectX software developer’s kit 

(SDK) throughout this discussion. The 
DSP code will be discussed in the next 
article of this series, which will dis- 
cuss the modulation and demodula- 
tion of quadrature signals in the SDR. 
Here are the steps involved in creat- 
ing the DirectX interface: 

e Install DirectX runtime and SDK. 


Option Explicit 


‘Define Constants 
Const Fs As Long = 
Const NFFT As Long = 4096 
Const BLKSIZE As Long = 2048 
Const CAPTURESIZE As Long = 


44100 


4096 


‘Define DirectX Objects 
Dim dx As New DirectX8 

Dim ds As DirectSounds8 

Dim 
Dim 
Dim 
Dim 


dsc As DirectSoundCaptures 


‘Define Type Definitions 
Dim dscbd As DSCBUFFERDESC 
Dim dsbd As DSBUFFERDESC 
Dim dspbd As WAVEFORMATEX 
Dim CapCurs As DSCURSORS 
Dim PlyCurs As DSCURSORS 


‘Create I/O Sound Buffers 


Dim inBuffer(CAPTURESIZE) As Integer 
As Integer 


Dim outBuffer (CAPTURESIZE) 


‘Define pointers and counters 
Dim Pass As Long 

Dim InPtr As Long 

Dim OutPtr As Long 

Dim StartAddr As Long 

Dim EndAddr As Long 

Dim CaptureBytes As Long 


dspb As DirectSoundPrimaryBuffers 


dsb As DirectSoundSecondaryBuffers8 
dscb As DirectSoundCaptureBuffers 


e Add a reference to DirectX8 for 
Visual Basic Type Library. 

e Define Variables, I/O buffers and 
DirectX objects. 

e Implement DirectX8 events and 
event handles. 

e Create the audio devices. 

e Create the DirectX events. 

e Start and stop capture and play buff- 
ers. 

e Process the DirectXEvent8. 

e Fill the play buffer before starting 
playback. 


‘Sampling frequency Hz 

‘Number of FFT bins 

‘Capture/play block size 
‘Capture Buffer size 


‘DirectX object 

‘DirectSound object 

‘Primary buffer object 
‘Capture object 

‘Output Buffer object 
‘Capture Buffer object 


‘Capture buffer description 


e Detect and correct overwrite errors. 

e Parse the stereo buffer into J and Q 
signals. 

e Destroy objects and events on exit. 
Complete functional source code for 

the DirectX driver written in Microsoft 

Visual Basic is provided for download 

from the QEX Web site.® 


Install DirectX and Register it 
within Visual Basic 


The first step is to download the 
DirectX driver and the DirectX SDK 


‘DirectSound buffer description 


‘Primary buffer description 
‘DirectSound Capture Cursor 
‘DirectSound Play Cursor 


‘Number of capture passes 


‘Capture Buffer block pointer 


‘Output Buffer block pointer 


‘Buffer block starting address 


‘Ending buffer block address 
‘Capture bytes to read 


‘Demodulator Input Buffer 
‘Demodulator Output Buffer 


‘Define loop counter variables for timing the capture event cycle 


Dim TimeStart As Double 


‘Start time for DirectX8Event loop 
‘Ending time for DirectX8Event loop 
‘Counts number of events to average 
‘Stores the average event cycle time 


Dim TimeEnd As Double 
Dim AvgCtr As Long 
Dim AvgTime As Double 


‘Set up Event variables for the Capture Buffer 

Implements DirectXEvent8 ‘Allows DirectX Events 

Dim hEvent (1) As Long ‘Handle for DirectX Event 

Dim EVNT(1) As DSBPOSITIONNOTIFY ‘Notify position array 
Dim Receiving As Boolean ‘In Receive mode if true 

Dim FirstPass As Boolean ‘Denotes first pass from Start 


Fig 5—Declaration of variables, buffers, events and objects. This code is located in the General section of the module or form. 
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from the Microsoft Web site (see Note 
3). Once the driver and SDK are in- 
stalled, you will need to register the 
DirectX8 for Visual Basic Type Li- 
brary within the Visual Basic devel- 
opment environment. 

If you are building the project from 
scratch, first create a Visual Basic 
project and name it “Sound.” When the 
project loads, go to the Project Menu/ 
References, which loads the form 
shown in Fig 4. Scroll through Avail- 
able References until you locate the 


DirectX8 for Visual Basic Type Library 
and check the box. When you press 
“OK,” the library is registered. 


Define Variables, Buffers and 
DirectX Objects 


Name the form in the Sound project 
frmSound. In the General section of 
frmSound, you will need to declare all 
of the variables, buffers and DirectX 
objects that will be used in the driver 
interface. Fig 5 provides the code that 
is to be copied into the General sec- 


tion. All definitions are commented in 
the code and should be self-explana- 
tory when viewed in conjunction with 
the subroutine code. 


Create the Audio Devices 


We are now ready to create the 
DirectSound objects and set up the 
format of the capture and play buff- 
ers. Refer to the source code in Fig 6 
during the following discussion. 

The first step is to create the 
DirectSound and DirectSoundCapture 


‘Set up the DirectSound Objects and the Capture and Play Buffers 


Sub CreateDevices () 


On Local Error Resume Next 


Set ds = 
Set dsc = 


dx.DirectSoundCreate (vbNullString) 
dx .DirectSoundCaptureCreate (vbNullString) 


‘Check to se if Sound Card is properly installed 


If Err.Number <> 0 Then 
MsgBox 
End 
End If 


“Unable to start DirectSound. 


‘DirectSound object 
‘DirectSound Capture 


Check proper sound card installation” 


‘Set the cooperative level to allow the Primary Buffer format to be set 
ds.SetCooperativeLevel Me.hWnd, DSSCL_ PRIORITY 


‘Set up format for capture buffer 


With dscbd 
With .fxFormat 
-nFormatTag = WAVE FORMAT PCM 
-nChannels = 2 ‘Stereo 
.lSamplesPerSec = Fs ‘Sampling rate in Hz 
-nBitsPerSample = 16 ‘16 bit samples 
-nBlockAlign = .nBitsPerSample / 8 * .nChannels 
.lAvgBytesPerSec = .1SamplesPerSec * .nBlockAlign 
End With 
.lFlags = DSCBCAPS DEFAULT 
.lBufferBytes = (dscbd.fxFormat.nBlockAlign * CAPTURESIZE) ‘Buffer Size 
CaptureBytes = .1BufferBytes \ 2 ‘Bytes for 1/2 of capture buffer 
End With 
Set dscb = dsc.CreateCaptureBuf fer (dscbd) ‘Create the capture buffer 


` Set up format for secondary playback buffer 


With dsbd 
.fxFormat = 
.lBufferBytes = 
.lFlags = 

End With 


dspbd = dsbd.fxFormat 
dspb.SetFormat dspbd 


Set dsb = 


End Sub 


ds.CreateSoundBuf fer (dsbd) 


dscbd.fxFormat 
dscbd.1BufferBytes * 2 
DSBCAPS GLOBALFOCUS Or DSBCAPS GETCURRENTPOSITION2 


‘Play is 2X Capture Buffer Size 


‘Set Primary Buffer format 
‘to same as Secondary Buffer 


Fig 6—Create the DirectX capture and playback devices. 


14 Sept/Oct 2002 QDE% 


‘Create the secondary buffer 


objects. We then check for an error to 
see if we have a compatible sound card 
installed. If not, an error message would 
be displayed to the user. Next, we set 
the cooperative level DSSCL_ PRIOR- 
ITY to allow the Primary Buffer format 
to be set to the same as that of the Sec- 
ondary Buffer. The code that follows sets 
up the DirectSoundCaptureBuffer- 


Description format and creates the 
DirectSoundCaptureBuffer object. The 
format is set to 16-bit stereo at the sam- 
pling rate set by the constant F's. 
Next, the DirectSoundBuffer- 
Description is set to the same format 
as the DirectSoundCaptureBuffer- 
Description. We then set the Primary 
Buffer format to that of the Second- 


‘Set events for capture buffer notification at 0 and 1/2 


Sub SetEvents () 


ary Buffer before creating the 
DirectSoundBuffer object. 


Set the DirectX Events 


As discussed earlier, the 
DirectSoundCaptureBuffer is divided 
into two blocks so that we can read 
from one block while capturing to the 
other. To do so, we must know when 


‘Event handle for first half of buffer 


‘Set event to first half of capture buffer 


hEvent (0) = dx.CreateEvent (Me) 

hEvent (1) = dx.CreateEvent (Me) ‘Event handle for second half of buffer 
‘Buffer Event 0 sets Write at 50% of buffer 

EVNT(0).hEventNotify = hEvent (0) 

EVNT(0).10ffset = (dscbd.1BufferBytes \ 2) - 1 

‘Buffer Event 1 Write at 100% of buffer 

EVNT(1).hEventNotify = hEvent (1) 

EVNT(1).10ffset = dscbd.1BufferBytes - 1 


dscb.SetNotificationPositions 2, 


End Sub 


Fig 7—Create the DirectX events. 


EVNT () 


‘Create Devices and Set the DirectX8Events 


Private Sub Form _Load() 
CreateDevices 
SetEvents 

End Sub 


‘Set Event to second half of capture buffer 


‘Set number of notification positions to 2 


‘Create DirectSound devices 


‘Set up DirectX events 


‘Shut everything down and close application 
Private Sub Form _Unload(Cancel As Integer) 


If Receiving = True Then 


dsb.Stop 
dscb.Stop 
End If 


Dim i As Integer 
For i = 
DoEvents 

If hEvent (i) 
Next 


Set dx = Nothing 


Set ds = Nothing 
Set dsc = Nothing 
Set dsb = Nothing 
Set dscb = Nothing 
Unload Me 

End Sub 


0 To UBound (hEvent) 


‘Stop Playback 
‘Stop Capture 


‘Kill DirectX Events 


Then dx.DestroyEvent hEvent (i) 


‘Destroy DirectX objects 


Fig 8—Create and destroy the DirectSound Devices and events. 
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DirectX has finished writing to a 
block. This is accomplished using the 
DirectXEvent8. Fig 7 provides the code 
necessary to set up the two events that 
occur when the lWrite cursor has 
reached 50% and 100% of the 

DirectSoundCaptureBuffer. 

We begin by creating the two event 
handles hEvent(0) and hEvent(1). The 
code that follows creates a handle for 
each of the respective events and sets 
them to trigger after each half of the 
DirectSoundCaptureBuffer is filled. 
Finally, we set the number of notifica- 
tion positions to two and pass the 
name of the EVNT() event handle ar- 
ray to DirectX. 

The CreateDevices and SetEvents 
subroutines should be called from the 
Form_Load() subroutine. The Form_ 
Unload subroutine must stop capture 
and playback and destroy all of the 
DirectX objects before shutting down. 
The code for loading and unloading is 
shown in Fig 8. 


Starting and Stopping 
Capture/Playback 


Fig 9 illustrates how to start and 
stop the DirectSoundCaptureBuffer. 
The dscb.Start DSCBSTART_ LOOP- 
ING command starts the Direct- 
SoundCaptureBuffer in a continuous 
circular loop. When it fills the first half 
of the buffer, it triggers the DirectX 
Event8 subroutine so that the data 
can be read, processed and sent to the 
DirectSoundBuffer. Note that the 
DirectSoundBuffer has not yet been 
started since we will quadruple buffer 
the output to prevent processor load- 
ing from causing gaps in the output. 
The FirstPass flag tells the event to 
start filling the DirectSoundBuffer for 
the first time before starting the buffer 
looping. 


Processing the Direct-XEvent8 


Once we have started the Direct- 
SoundCaptureBuffer looping, the 
completion of each block will cause the 
DirectX Event8 code in Fig 10 to be 
executed. As we have noted, the events 
will occur when 50% and 100% of the 
buffer has been filled with data. Since 
the buffer is circular, it will begin 
again at the 0 location when the buffer 
is full to start the cycle all over again. 
Given a sampling rate of 44,100 Hz 
and 2048 samples per capture block, 
the block rate is calculated to be 
44,100/2048 = 21.53 blocks/s or one 
block every 46.4 ms. Since the quad 
buffer is filled before starting playback 
the total delay from input to output is 
4 x 46.4 ms = 185.6 ms. 

The DirectX Event8_DXCallback 
event passes the eventid as a variable. 
The case statement at the beginning of 
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the code determines from the eventid, 
which half of the DirectSoundCapture- 
Buffer has just been filled. With that 
information, we can calculate the start- 
ing address for reading each block from 
the DirectSoundCaptureBuffer to the 
inBuffer() array with the dscb. 
ReadBuffer command. Next, we simply 
pass the inBuffer() to the external DSP 
subroutine, which returns the processed 
data in the outBuffer() array. 

Then we calculate the StartAddr 
and EndAddr for the next write loca- 
tion in the DirectSoundBuffer. Before 
writing to the buffer, we first check to 
make sure that we are not writing 
between the Write and 1Play cursors, 
which will cause portions of the buffer 
to be overwritten that have already 
been committed to the output. This 
will result in noise and distortion in 
the audio output. If an error occurs, 
the FirstPass flag is set to true and 
the pointers are reset to zero so that 
we flush the DirectSoundBuffer and 
start over. This effectively performs an 
automatic reset when the processor is 
overloaded, typically because of graph- 
ics intensive applications running 
alongside the SDR application. 

If there are no overwrite errors, we 
write the outBuffer() array that was 
returned from the DSP routine to the 
next StartAddr to EndAddr in the 
DirectSoundBuffer. Important note: In 
the sample code, the DSP subroutine 
call is commented out and the 
inBuffer() array is passed directly to 
the DirectSoundBuffer for testing of 
the code. When the FirstPass flag is 
set to True, we capture and write four 
data blocks before starting playback 
looping with the .SetCurrentPosition 
0 and .Play DSBPLAY_LOOPING 
commands. 

The subroutine calls to StartTimer 
and StopTimer allow the average com- 
putational time of the event loop to be 
displayed in the immediate window. 
This is useful in measuring the effi- 


‘Turn Capture/Playback On 
Private Sub cmdOn_Click() 
dscb.Start DSCBSTART_ LOOPING 


Receiving = True 
FirstPass = True 
Start 
OutPtr = 0 
End Sub 


‘Turn Capture/Playback Off 
Private Sub cmdOff Click() 


Receiving = False 
FirstPass = False 
dscb.Stop 
dsb.Stop 

End Sub 


ciency of the DSP subroutine code that 
is called from the event. In normal 
operation, these subroutine calls 
should be commented out. 


Parsing the Stereo Buffer 
into I and Q Signals 


One more step that is required to 
use the captured signal in the DSP 
subroutine is to separate or parse the 
left and right channel data into the I 
and Q signals, respectively. This can 
be accomplished using the code in 
Fig 11. In 16-bit stereo, the left and 
right channels are interleaved in the 
inBuffer() and outBuffer(). The code 
simply copies the alternating 16-bit 
integer values to the RealIn()), (same 
as I) and ImagIn(), (same as Q) buff- 
ers respectively. Now we are ready to 
perform the magic of digital signal 
processing that we will discuss in the 
next article of the series. 


Testing the Driver 


To test the driver, connect an audio 
generator—or any other audio device, 
such as a receiver—to the line input of 
the sound card. Be sure to mute line- 
in on the mixer control panel so that 
you will not hear the audio directly 
through the operating system. You can 
open the mixer by double clicking on 
the speaker icon in the lower right cor- 
ner of your Windows screen. It is also 
accessible through the Control Panel. 

Now run the Sound application and 
press the On button. You should hear 
the audio playing through the driver. 
It will be delayed about 185 ms from 
the incoming audio because of the qua- 
druple buffering. You can turn the 
mute control on the line-in mixer on 
and off to test the delay. It should 
sound like an echo. If so, you know that 
everything is operating properly. 


Coming Up Next 


In the next article, we will discuss 
in detail the DSP code that provides 


‘Start Capture Looping 
‘Set flag to receive mode 
‘This is the first pass after 


‘Starts writing to first buffer 


‘Reset Receiving flag 
‘Reset FirstPass flag 
‘Stop Capture Loop 
‘Stop Playback Loop 


Fig 9—Start and stop the capture/playback buffers. 


call DSP routines, and output to Secondary Play Buffer 
(ByVal eventid As Long) 


‘Process the Capture events, 
Private Sub DirectXEvent8 DXCallback 


StartTimer ‘Save loop start time 


Select Case eventid ‘Determine which Capture Block is ready 


Case hEvent (0) 


InPtr = 0 ‘First half of Capture Buffer 
Case hEvent (1) 
InPtr = 1 ‘Second half of Capture Buffer 


End Select 


StartAddr ‘Capture buffer starting address 


InPtr * CaptureBytes 


‘Read from DirectX circular Capture Buffer to inBuffer 


dscb.ReadBuffer StartAddr, CaptureBytes, inBuffer(0), DSCBLOCK DEFAULT 


THE DSP CODE IS CALLED 


THIS IS WHERE 


‘DSP Modulation/Demodulation - NOTE: 
` DSP inBuffer, outBuffer 


StartAddr = OutPtr * CaptureBytes ‘Play buffer starting address 
EndAddr = OutPtr + CaptureBytes - 1 ‘Play buffer ending address 
With dsb ‘Reference DirectSoundBuffer 


.GetCurrentPosition PlyCurs 


‘Get current Play position 


‘If true the write is overlapping the lWrite cursor due to processor loading 
If PlyCurs.1Write >= StartAddr _ 
And PlyCurs.1Write <= EndAddr Then 


FirstPass = True ‘Restart play buffer 
OutPtr = 0 
StartAddr = 0 


End If 


‘If true the write is overlapping the 1Play cursor due to processor loading 
If PlyCurs.1Play >= StartAddr _ 
And PlyCurs.1Play <= EndAddr Then 


FirstPass = True ‘Restart play buffer 
OutPtr = 0 
StartAddr = 0 


End If 


NOTE: 


‘Write outBuffer to DirectX circular Secondary Buffer. writing inBuffer causes 


direct pass through. Replace 
‘with outBuffer below to when using DSP subroutine for modulation/demodulation 
-WriteBuffer StartAddr, CaptureBytes, inBuffer(0), DSBLOCK_ DEFAULT 


OutPtr OutPtr + 1) ‘Counts 0 to 3 


II£(OutPtr >= 3, 0, 


‘On FirstPass wait 4 counts before starting 


If FirstPass True Then 


Pass = Pass + 1 ‘the Secondary Play buffer looping at 0 

If Pass = 3 Then ‘This puts the Play buffer three Capture cycles 
FirstPass = False ‘after the current one 
Pass = 0 ‘Reset the Pass counter 


‘Set playback position to zero 
‘Start playback looping 


.SetCurrentPosition 0 
.Play DSBPLAY LOOPING 
End If 
End If 


End With 


StopTimer ‘Display average loop time in immediate window 


End Sub 


Fig 10—Process the DirectXEvent8 event. Note that the example code passes the inBuffer() directly to the DirectSoundBuffer 
without processing. The DSP subroutine call has been commented out for this illustration so that the audio input to the sound 
card will be passed directly to the audio output with a 185 ms delay. Destroy objects and events on exit. 
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Erase RealIn, ImagIn 


For S = 0 To CAPTURESIZE - 1 Step 2 ‘Copy I to RealIn and Q to ImagIn 
RealIn(S \ 2) = inBuffer(S) 
Imagin(S \ 2) = inBuffer(S + 1) 

Next S 


Fig 11—Code for parsing the stereo inBuffer() into in-phase and quadrature signals. This code must be imbedded into the DSP 
subroutine. 


modulation and demodulation of SSB The DirectX runtime driver may be down- %You can download this package from the 
signals. Included will be source code loaded from www.microsoft.com/windows/ ARRL Web www.arrl.org/qexfiles/. Look 


for implementing ultra-high-perfor- directx/downloads/default.asp. for 0902Y oungblood.zip. oo 


mance variable band-pass filtering in 

the frequency domain, offset baseband 

IF processing and digital AGC. 

Notes 

1G. Youngblood, AC50G, “A Software- 
Defined Radio for the Masses: Part 1,” 
QEX, July/Aug 2002, pp 13-21. 

2Information on both DirectX and Windows 
Multimedia programming can be accessed 
on the Microsoft Developer Network (MSDN) 
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